home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2002 November / SGI Freeware 2002 November - Disc 3.iso / relnotes / shared / faq.data < prev    next >
Text File  |  2002-10-07  |  32KB  |  862 lines
  1. <!-- -*- HTML -*- -->
  2. <!-- INCLUDE SIDENAV -->
  3. <!-- NO HIGHLIGHTS -->
  4.  
  5. <!-- BEGIN TITLE -->
  6. <TITLE>FAQ: SGI/Freeware Frequently Asked Questions</TITLE>
  7. <META NAME="keywords"     CONTENT="SGI, IRIX, Freeware, FAQ, frequently asked questions">
  8. <META NAME="description" CONTENT="Frequently asked questions about SGI IRIX freeware">
  9. <META NAME="owner"       CONTENT="freeware@sgi.com">
  10. <!-- END TITLE -->
  11.  
  12. <!-- BEGIN CONTENTS -->
  13. <H2>Frequently Asked Questions</H2>
  14.  
  15. <p>
  16. <H3><a href="#installation">Installation Problems</a></H3>
  17. <ul>
  18. <li><a href="#Q1.1">Q1.1: How do I install a package on IRIX?</a>
  19. <li><a href="#Q1.2">Q1.2: I can't view the man pages...</a>
  20. <li><a href="#Q1.3">Q1.3: Some packages are too big to download...</a> 
  21. <li><a href="#Q1.4">Q1.4: I get this error after installation: <i>(/bin/sh: ... mkindex.sh: not found ...)</i></a>
  22. <li><a href="#Q1.5">Q1.5: I'm getting <i>"missing prereqs"</i> when installing on IRIX 6.2</a>
  23. <li><a href="#Q1.6">Q1.6: Can I install freeware in a different directory?</a>
  24. <li><a href="#Q1.7">Q1.7: Where can I find <code>eoe.sw64.lib</code>?</a>
  25. </ul>
  26.  
  27. <H3><a href="#runtime">Run Time Problems</a></H3>
  28. <ul>
  29. <li><a href="#Q2.1">Q2.1: prog: rld: Fatal Error: <i>(library version mismatch)...</i></a>
  30. <li><a href="#Q2.2">Q2.2: prog: rld: Fatal Error: <i>(cannot successfully map soname)...</i></a>
  31. <li><a href="#Q2.3">Q2.3: gcc can't find 'as'.</a>
  32. <li><a href="#Q2.4">Q2.4: Where is the xemacs binary?</a>
  33. <li><a href="#Q2.5">Q2.5: perl: rld: Fatal Error: attempted access to unresolvable symbol in...</a>
  34. </ul>
  35.  
  36. <H3><a href="#misc">Miscellaneous</a></H3>
  37. <ul>
  38. <li><a href="#Q3.1">Q3.1: Could you please add package X?</a>
  39. <li><a href="#Q3.2">Q3.2: How about open source packages for older IRIX versions?</a>
  40. <li><a href="#Q3.3">Q3.3: How can I order a set of freeware CDs?</a>
  41. <li><a href="#Q3.4">Q3.4: What is package X? How do I run/configure it?</a>
  42. <li><a href="#Q3.5">Q3.5: Where is the source?</a>
  43. <li><a href="#Q3.6">Q3.6: Is freeware Y2K compliant?</a>
  44. <li><a href="#Q3.7">Q3.7: I want to contribute to SGI/freeware...</a>
  45. <li><a href="#Q3.8">Q3.8: How can I compile with a freeware library?</a>
  46. </ul>
  47.  
  48. <H3><a href="#gnome">GNOME</a></H3>
  49. <ul>
  50. <li><a href="#Q4.1">Q4.1: What freeware images do I need to install to run GNOME?</a>
  51. <li><a href="#Q4.2">Q4.2: How can I start GNOME automatically at login?</a>
  52. <li><a href="#Q4.3">Q4.3: Why do I get BadMatch errors, crashes, blue-on-blue text, etc.?</a>
  53. <li><a href="#Q4.4">Q4.4: How can I make enlightenment run faster?</a>
  54. <li><a href="#Q4.5">Q4.5: Why are sounds garbled or noisy?</a>
  55. <li><a href="#Q4.6">Q4.6: Why don't gtop and other system monitoring tools work?</a>
  56. </ul>
  57.  
  58. <H3><a href="#history">Package Replacement History</a></H3>
  59. <ul>
  60. <li><a href="#Q5.1">Q5.1: What packages are known Y2K fixed?</a>
  61. <li><a href="#Q5.2">Q5.2: What packages have been replaced or obsoleted?</a>
  62. <li><a href="#Q5.3">Q5.3: What packages have been renamed?</a>
  63. </ul>
  64.  
  65. <!-- ================================================================  -->
  66. <hr noshade>
  67. <h2><a name="installation">Installation Problems</a></h2>
  68.  
  69. <dl>
  70.  
  71. <dt><a name="Q1.1"><b>Q1.1: How do I install a package on IRIX?</b></a>
  72.  
  73. <p><dd>Open source comes in <code>.tardist</code> extension files.
  74. <code>tardist</code> files are <code>tar</code> archives of
  75. <code>inst</code> (SGI auto-install) files.  
  76. They normally install automatically when you click on them
  77. in your browser.  If you didn't have auto-installation configured in
  78. your browser this may fail, in which case you
  79. may follow the following manual procedure:<pre>
  80.     % tar xvf xxxx.tardist    # untar that tardist file
  81.     % su            # become superuser
  82.     # inst -f .            # install from current dir
  83.     inst> go
  84.     inst> quit</pre>
  85.  
  86. <h4>Automating this process:</h4>
  87. The utility <code>tardist</code> does all the above automatically.
  88. To configure your browser to support auto-install (i.e. calling
  89. <code>tardist</code> or <code>SoftwareManager</code> automatically
  90. when you click on a <code>.tardist</code>
  91. file on the web) you should have two entries added to your mailcap
  92. file (either your personal <code>~/.mailcap</code> or, depending on
  93. your browser version, the system one in <code>/var/netscape/.../mailcap</code>,
  94. <code>/usr/local/.../mailcap</code>, or equivalent).<pre>
  95.     application/x-install; \
  96.     /usr/sbin/SoftwareManager -a -F %s ; \
  97.     description="SGI automatic software installation"
  98.     application/x-tardist; \
  99.     /usr/sbin/SoftwareManager -a -f %s ; \
  100.     description="SGI software distribution archive"</pre>
  101.  
  102. All this should work out of the box on recent IRIX releases.
  103. It is just on older IRIX systems (6.2) that you may need to go
  104. through the manual procedure.
  105.  
  106. <p>
  107. <dt><a name="Q1.2"><b>Q1.2: I can't view the man pages...</b></a>
  108. <p>
  109. <dd>All packages come with the full original documentation
  110. if it exists.
  111. However they are configured to install their man pages under
  112. <code>/usr/freeware/...</code>  which is a non-standard
  113. location to search for man pages.   To make this work,
  114. you must tell the <code>man</code> program to search there.
  115.  
  116. <p>
  117. You may do it either by setting <code>MANPATH</code> using something like:
  118. <pre>
  119.     % setenv MANPATH /usr/freeware/catman:/usr/freeware/man:\
  120.     /usr/catman/local:/usr/local/man:/usr/share/catman:\
  121.     /usr/share/man:/usr/catman:/usr/man</pre>
  122.  
  123.  
  124. (note the added <code>/usr/freeware/catman</code> location).
  125.  
  126. <p>
  127. Or simply follow the instructions on the SGI Freeware web page
  128. which recommend running the utility <code>fixpath</code>.
  129. <code>fixpath</code> is included with every package
  130. as <code>fw_common.sw.fixpath</code>.  You should run <code>fixpath</code>
  131. only once to update your personal startup files. Once you run
  132. <code>fixpath</code> you should re-login for it to take effect
  133. (or directly execute your fixed startup files <code>(e.g:
  134.  source ~/.cshrc)</code>) from your shell.
  135.  
  136. <p>
  137. <dt><a name="Q1.3"><b>Q1.3: Some packages are too big to download...</b></a>
  138.  
  139. <p>
  140. <dd>HTTP implementations seem to time out and fail on slow links
  141. and big files.  The symptom is getting a timeout or some error message
  142. like "premature EOF" from Software Manager during the unpacking
  143. of the <code>tardist</code> file.
  144. <p>
  145. Good solutions are to use FTP instead of HTTP, or to use a 
  146. <a href="mirrors.html">local mirror</a> of the freeware archives.
  147.  
  148. <p>You may access SGI/freeware via FTP using any of the following methods:
  149. <p>
  150. <ul>
  151.     <li>Use <a href="ftp://freeware.sgi.com/index.html"><i>ftp://freeware.sgi.com/index.html</i></a>
  152.     instead of <a href="http://freeware.sgi.com/"><i>http://freeware.sgi.com/</i></a>
  153.  
  154.     <p>
  155.     <li>Use an FTP client to connect to <i>freeware.sgi.com</i>
  156.     where the whole content of the web site is available via ftp.
  157.  
  158.     <p>
  159.     <li>Click on the <a href="ftp://freeware.sgi.com/index.html"><b><i>Switch to FTP</i></b></a> link
  160.     in the top level web page to switch your browser to the
  161.     FTP protocol during your visit to the SGI/Freeware site.
  162. </ul>
  163.  
  164. <p>
  165. <dt><a name="Q1.4"><b>Q1.4: I get this error after installation: <i>(/bin/sh: ... mkindex.sh: not found ...)</i></b></a>
  166. <p>
  167. <dd>
  168. Some very old freeware packages produce this error message during installation:<pre>
  169. /bin/sh: \//usr/freeware/relnotes/shared/mkindex.sh:  not found
  170. ERROR: Command "( \\$rbase/usr/freeware/relnotes/shared/mkindex.sh )"
  171. failed (return status 127, subsystem XXXXX.man.relnotes 1022574820)</pre>
  172.  
  173. You may safely ignore this message.  This is an old package (from
  174. Freeware release 6.2).  Some of these old packages were not re-packaged
  175. for the current Freeware release.  Instead, they were simply recycled
  176. "as-is".  The error is benign and is a result of a typo in the exitop.
  177. The software itself should run fine.
  178.  
  179. <p>
  180. <dt><a name="Q1.5"><b>Q1.5: I'm getting <i>"missing prereqs"</i> when installing on IRIX 6.2</b></a>
  181. <p>
  182. <dd>That's because the current freeware distribution is built for IRIX 6.5.
  183. See <a href="#Q3.2">Q3.2</a> below for more information.
  184.  
  185. <p>
  186. <dt><a name="Q1.6"><b>Q1.6: Can I install freeware in a different directory?</b></a>
  187. <p>
  188. <dd>This question is often being asked by people who don't
  189. have superuser permissions and/or whose sysadmin disabled tardist
  190. on their system so they cannot install into <code>/usr/freeware</code>
  191. via the web, or something similar.  Unfortunately, the answer to this is no.
  192. Many packages are preconfigured to look for files in certain directories
  193. so moving them will simply break them.  While some packages may not be
  194. sensitive to locations we simply don't have the resources to support
  195. such feature by creating alternate distributions.
  196.  
  197. <p>Note that if you are short on disk space you can move the
  198. <code>/usr/freeware</code> directory to a different location; just
  199. make sure to leave a symlink behind so that the original path names
  200. still work.  Moving individual subdirectories of <code>/usr/freeware</code> 
  201. may or may not work.
  202.  
  203. <p>
  204. <dt><a name="Q1.7"><b>Q1.7: Where can I find <code>eoe.sw64.lib</code>?</b></a>
  205. <p>
  206. <dd>The clever answer is that if the Software Manager had to ask, then
  207. you probably don't need it after all.
  208.  
  209. <p>First a little background: IRIX supports three different calling
  210. conventions: -o32 (which is basically obsolete), -n32 (the default,
  211. which is usable everywhere), and -64 (only usable on systems with an
  212. IRIX64 kernel, where "<code>uname</code>" returns "IRIX64").  The
  213. freeware "sw64" subsystems contain 64-bit versions of the same
  214. programs and libraries that are in the regular "sw" subsystems.  They
  215. install by default on systems capable of running 64-bit programs, but
  216. rarely do anything differently.  Very few programs actually require
  217. 64-bit addresses or bother to use the 64-bit library routines when
  218. available.  Mainly the subsys are present for people who want to
  219. cross-compile 64-bit programs on 32-bit systems.
  220.  
  221. <p>So if you get a conflict message installing freeware that says you
  222. also need to install <code>eoe.sw64.lib</code> a very plausible
  223. resolution is to not install ("keep") whatever subsystem had this
  224. prerequisite.  If you really want to load that subsystem you'll need
  225. both your base IRIX 6.5 CDs plus the IRIX 6.5.x overlay disks for
  226. the release you are running.  The same logic applies for
  227. <code>x_eoe.sw64.eoe</code> and <code>ifl_eoe_sw64.eoe</code>.
  228.  
  229. </dl>
  230.  
  231.  
  232.  
  233. <!-- ================================================================  -->
  234. <hr noshade>
  235. <h2><a name="runtime">Run Time problems</a></h2>
  236.  
  237. <dl>
  238. <dt><a name="Q2.1"><b>Q2.1: prog: rld: Fatal Error: <i>(library version mismatch)...</i>:</b></a>
  239. <p>
  240. <dd>If you get an error message like this when running a package the
  241. runtime linker is having problems finding the right versions of libraries:<pre>
  242.     gnuplot: rld: Fatal Error: object libpng.so from liblist in gnuplot
  243.     has version "sgi1.0", which does not match the found object:
  244.     /usr/lib32/libpng.so (with version "sgi2.0")</pre>
  245. <p>
  246. There are two possible solutions.
  247. <ul>
  248.     <li>Best: Upgrade to a more recent version of <code>libpng.so</code>
  249.            
  250.     <li>Fastest/simplest (csh/tcsh example):
  251.     Tell <code>rld</code> to ignore versions in this particular case:<pre>
  252. alias gnuplot 'env _RLD_ARGS=-ignore_all_versions gnuplot \!*'</pre>
  253. </ul>
  254.  
  255. Substitute <code>gnuplot</code> with your failing program name
  256. if it is different.
  257.  
  258. <p>
  259. <dt><a name="Q2.2"><b>Q2.2: prog: rld: Fatal Error: <i>(cannot successfully map soname)...</i></b></a>
  260. <p>
  261. <dd>
  262. Since May 2001 (when we dropped support for pre-IRIX 6.5 systems)
  263. freeware packages have been built with the MipsPRO 7.3 compilers.
  264. If you are running on IRIX 6.5.9 or earlier you <i>must</i> install the
  265. following patches or their successors:
  266. <ul>
  267. <li>patch 3742 (5 MB) -- c++_eoe (includes libCio.so)
  268. <li>patch 3743 (160 MB) -- fortran_eoe
  269. <li>patch 3911 (19 MB) -- compiler_eoe (except libmp)
  270. <li>patch 4330 (2 MB) -- compiler_eoe (libmp)
  271. </ul>
  272. Failure to do so can result in various strange errors, such as rld
  273. complaining that it cannot find <code>libCio.so.1</code> at runtime.
  274. Patches can be downloaded from
  275. <a href="http://www.sgi.com/support/patch_intro.html">http://www.sgi.com/support/patch_intro.html</a>
  276. Or you can upgrade to a newer IRIX 6.5.x release; upgrades in the 'm'
  277. stream are free.
  278.  
  279. <p>
  280. If you get an error message like this when running a package
  281. the runtime linker is having problems finding libraries:<pre>
  282.     prog: rld: Fatal Error: cannot successfully map soname
  283.     'libXpm.so.1' under any of the filenames
  284.     /usr/lib32/libXpm.so.1:/lib32/libXpm.so.1:/usr/libn32/libXpm.so.1:\
  285.     /libn32/libXpm.so.1:/usr/lib32/libXpm.so.1.1:/lib32/libXpm.so.1.1:\
  286.     /usr/libn32/libXpm.so.1.1:/libn32/libXpm.so.1.1:</pre>
  287.  
  288. <p>This should not happen if you have all the prerequisite libraries
  289. installed, but if you suppressed some conflicts during installation or
  290. manually removed some libraries (without using <b>inst</b>) later you
  291. may run into problems like this.  Or it could be that we forgot to
  292. declare some prerequisite library.  Do "<code>showfiles</code>" and
  293. search the output for the missing library; then look to see if it
  294. exists on your system.  If not, reinstall the package that contained
  295. it.
  296.  
  297. <p>
  298. <dt><a name="Q2.3"><b>Q2.3: gcc can't find 'as'.</b></a>
  299. <p>
  300. <dd>Please click on the name of the package in the download table
  301. (leftmost cell) to get to the brief release notes and follow them.
  302. In this specific case, it includes instructions on how to get
  303. the SGI assembler and linker which are not a part of gcc.
  304. (If you have installed <code>fw_gcc</code> the release notes will 
  305. also be in 
  306. <a href="file:///usr/freeware/relnotes/gcc.html">/usr/freeware/relnotes/gcc.html</a>).
  307.  
  308. <p>
  309. <dt><a name="Q2.4"><b>Q2.4: Where is the xemacs binary?</b></a>
  310. <p>
  311. <dd>You need to manually select and install either the
  312. "MULE-free" (<code>fw_xemacs.latin1.eoe</code>) or 
  313. "MULE-fied" (<code>fw_xemacs.mule.eoe</code>) subsystem,
  314. depending on how much foreign language support you want.
  315. When installing xemacs click on the "Customize" button in the software
  316. manager, and click on the little folder icon next to
  317. XEmacs product.  Select the subsystem you want and hit "Start".
  318.  
  319. <p>
  320. This is fixed in the current release.
  321.  
  322.  
  323. <p>
  324. <dt><a name="Q2.5"><b>Q2.5: perl: rld: Fatal Error: attempted access to unresolvable symbol in...</b></a>
  325. <p>
  326. <dd>
  327. This message will appear whenever you try to use <code>DB_File</code>
  328. or <code>GDBM_File</code> in perl5.6.1 (package version 1277898120).
  329. This is due to a build error.  For <code>DB_File</code> this can be
  330. worked around by including the appropriate ABI version of
  331. /usr/freeware/lib{,32,64} in LD_LIBRARY{,N32,64}_PATH environment
  332. variable.  There is no useful or general workaround for the
  333. <code>GDBM_File</code> bug except to revert to the previous version of
  334. fw_perl (perl5.005_03).  This will be fixed in a future release.
  335.  
  336. <p>
  337. For those interested in the details, Perl's "smart" configurator
  338. (which attempts to "DWIM": Do What I Mean) overrode the packager's "I
  339. know what I'm doing" configuration instructions, and got it wrong.
  340.  
  341. </dl>
  342.  
  343. <!-- ================================================================  -->
  344. <hr noshade>
  345. <h2><a name="misc">Miscellaneous</a></h2>
  346. <dl>
  347.  
  348. <dt><a name="Q3.1"><b>Q3.1: Could you please add package X?</b></a>
  349. <p>
  350. <dd>Thanks for the request.  All the open source packaging is done
  351. by volunteers so we cannot promise anything.  Your request is noted
  352. and it is possible that someone would volunteer to contribute it.
  353. You may want to build it yourself and send us a pointer to your package
  354. so others may benefit as well.  If you don't have the SGI development
  355. tools you may use the GNU compiler which is available in our
  356. recent distributions.
  357. If you do, please check-out the <a href="howto.html">Notes on
  358. building open source packages on IRIX</a> document.
  359.  
  360. <p>Two particularly frequent requests are <code>ssh</code>
  361. and <code>PGP</code>.  Note that according to U.S. law, we are not
  362. allowed to export crypto so we simply add pointers to such software
  363. which was built and distributed by other kind people.
  364. Try following the "More Freeware" link from the top
  365. <i>SGI/Freeware</i> page.
  366.  
  367. <p>
  368. We sometimes get requests for stuff that comes standard on IRIX
  369. like <code>gzip</code> or <code>rcs</code>.  Please check your IRIX
  370. CD's, maybe what you want is already there...  Specifically,
  371. RCS should be found in <code>eoe.sw.rcs</code>.
  372.  
  373. <p>
  374. <dt><a name="Q3.2"><b>Q3.2: How about packages for older IRIX versions?</b></a>
  375.  
  376. <p>
  377. <dd>Due to limited resources, new open source packages are built on
  378. IRIX 6.5 (which has been out since 1998...) so they should install and
  379. run on IRIX 6.5 and up but not on older versions.  You may find newer
  380. versions of these packages on the net, in places like 
  381. <a href="http://ftp.mayn.de/pub/irix/oldstuff/INDEX.html">http://ftp.mayn.de/</a>.
  382.  
  383. <p>
  384. Freeware distributions through May 2001 were built on IRIX 6.2.
  385. Packages built prior to August 2001 should install and run on IRIX 6.2
  386. and up.  The <a href="http://freeware.sgi.com/fw-6.2/">May
  387. 2001</a> distribution is still online.  An even older open source
  388. release (called Freeware 1.0) was built on IRIX 5.3 and is also
  389. available <a href="http://freeware.sgi.com/fw-5.3/">online</a>.
  390.  
  391. <p>
  392. Note that these older versions are not being actively maintained,
  393. enriched, or updated.  If you run older IRIX versions on relatively
  394. new hardware (Indy, Indigo2, Challenge, Origin), we highly recommend
  395. upgrading IRIX to a latest version. IRIX 6.5 is a very stable, fast,
  396. well supported, multi-platform, and feature rich version of IRIX.
  397.  
  398.  
  399. <p>
  400. <dt><a name="Q3.3"><b>Q3.3: How can I order a set of freeware CDs?</b></a>
  401.  
  402. <p>
  403. <dd>Unfortunately, these CDs are goodwill freebies.  They are not
  404. in our price book and we do not sell them so you cannot order them.
  405. But there are a few ways around this:
  406. <p>
  407. <ul>
  408.     <li>Order an IRIX system.  The CDs come with it.
  409.     <li>Download the CD contents with
  410.     <a href="http://freeware.sgi.com/index-by-alpha.html#rsync">rsync</a>
  411.     or <a href="http://freeware.sgi.com/index-by-alpha.html#wget">wget</a>
  412.     and burn your own using
  413.     <a href="http://freeware.sgi.com/index-by-alpha.html#cdrtools">cdrtools</a>. 
  414.     The expanded images (to make downloading easier) are in:
  415.     <ol>
  416.     <li><a href="ftp://freeware.sgi.com/cd-1/">ftp://freeware.sgi.com/cd-1/</a>
  417.     <li><a href="ftp://freeware.sgi.com/cd-2/">ftp://freeware.sgi.com/cd-2/</a>
  418.     <li><a href="ftp://freeware.sgi.com/cd-3/">ftp://freeware.sgi.com/cd-3/</a>
  419.     <li><a href="ftp://freeware.sgi.com/cd-4/">ftp://freeware.sgi.com/cd-4/</a>
  420.     </ol>
  421.     <!-- This is still an option, but don't advertise it to save money.
  422.     <li>If you have a support contract call the 
  423.     <a href="http://www.sgi.com/support/supportcenters.html">Customer
  424.     Support Center</a> and order a set.
  425.     -->
  426.     <li>Join the <a href="http://www.sgi.com/developers/">SGI
  427.     Developer Program</a> at the free Venture Online membership level
  428.     and <a href="http://toolbox.sgi.com/TasteOfDT/joinProg.html">pay
  429.         a US$100 yearly subscription fee</a> to receive two Developer's
  430.         Toolbox CD releases.  Although not released as frequently as
  431.     Freeware CDs, the Developer's Toolbox CDs include the latest freeware 
  432.     release when created.
  433. </ul>
  434.  
  435.  
  436. <p>
  437. <dt><a name="Q3.4"><b>Q3.4: What is package X? How do I run/configure it?</b></a>
  438.  
  439. <p>
  440. <dd>We try (but cannot commit) to provide a short description
  441. of the packages on our web site.  Click on the name of the package
  442. to get to the brief description.  Some basic questions can be
  443. avoided by clicking on the name of the package on the leftmost cell
  444. in the download table (note that this is different than the
  445. Download button or the rightmost cell).
  446.  
  447. <p>
  448. Our volunteers normally build and package the software
  449. and give it some testing but we do not provide documentation
  450. beyond what comes standard in the package.  You may want to contact
  451. the original authors and ask for better docs.
  452. See also <a href="#Q1.2">Q1.2</a>.
  453.  
  454.  
  455. <p>
  456. <dt><a name="Q3.5"><b>Q3.5: Where is the source?</b></a>
  457.  
  458. <p>
  459. <dd>The source for nearly all packages is included in a non-default
  460. <code>src</code> subsys.  To get the original source plus any changes
  461. we made locally start to install the package as usual, but press
  462. the "Customize" button in the Software Manager.  Click on the little
  463. folder icon next to the main package to expand it, and then select the
  464. source subsystem for installation and press "Go".  The source tarball
  465. and a diff file will be placed under <code>/usr/freeware/src</code>.
  466.  
  467. <p>
  468. You can also obtain source from the original authors, just as we did.
  469. The package release notes often give a URL for the package home page.
  470.  
  471.  
  472. <p>
  473. <dt><a name="Q3.6"><b>Q3.6: Is freeware Y2K compliant?</b></a>
  474.  
  475. <p>
  476. <dd>In general: SGI can not guarantee the Y2K compliance of
  477. these packages since they are not written nor maintained
  478. by SGI.  Also, we have no resources to do Y2K testing
  479. as we do for IRIX.  If this issue is critical to you
  480. we recommend you devote the resources to scan the included 
  481. source and report bugs to the original maintainers (not SGI).
  482. See also <a href="#Q5.1">Q5.1</a>.
  483.  
  484.  
  485. <p>
  486. <dt><a name="Q3.7"><b>Q3.7: I want to contribute to SGI/freeware...</b></a>
  487.  
  488. <p>
  489. <dd>Thanks very much for the offer. This is highly appreciated.
  490. We have a few reasons why we don't just take precompiled packages
  491. from external contributors:
  492.  
  493. <p>
  494. <ul>
  495.     <li>Security (obviously)
  496.     <p>
  497.     <li>Adherence to pretty elaborate build conventions + process
  498.     (which are unlikely to exist in random builds):
  499.     <ul>
  500.         <li>IRIX 6.5 and up runtime backward compatibility
  501.         <li>Using our latest compilers + patches
  502.         <li>n32 builds with full optimizations
  503.         <li>Install in standard places that don't clash with existing SW
  504.         <li>Taking care of dependencies and/or clashes with shared libs
  505.         <li>Various additional automatic checks of the packages
  506.     </ul>
  507. </ul>
  508.  
  509. <p>
  510. What you can do is port software to IRIX and send any patches to the
  511. official maintainers (and to us).  If you distribute your own packages
  512. please do not install them under <code>/usr/freeware</code>, or give
  513. them names beginning with "<code>fw_</code>".  If you do it's likely to
  514. cause trouble if/when we eventually add it to our distribution.
  515.  
  516. <p>
  517. To help other SGI users without endorsement we do, however,
  518. refer to external packages using links from our web site.
  519. If you could place your contributed package out on the net
  520. and send us a pointer, we'll gladly add a link to your
  521. contributed freeware from our web site's "More Freeware" section.
  522.  
  523.  
  524. <p>
  525. <dt><a name="Q3.8"><b>Q3.8: How can I compile with a freeware library?</b></a>
  526.  
  527. <p>
  528. <dd>Basically you need to tell the compiler where to find the header
  529. files, and you need to tell the linker where to find the libraries.
  530. (If the libraries are built properly <b>rld</b> will know where to
  531. find the shared libraries at runtime from the internal
  532. <code>rpath</code> settings.)  See the individual library
  533. package release notes for any additional details.
  534.  
  535. <p>Include the following flag on your compile lines to tell the
  536. compiler where to find the library's header files:
  537. <ul><pre>
  538. <li>-I/usr/freeware/include</li>
  539. </pre></ul>
  540. Including the following flag on your link lines will cause the linker
  541. to correctly find the library's archive or shared object files at link
  542. time.
  543. <ul><pre>
  544. <li>-L/usr/freeware/lib32 (if using n32 ABI)</li>
  545. <li>-L/usr/freeware/lib64 (if using 64 ABI)</li>
  546. </pre></ul>
  547. The <code>-L</code> flag must appear on the link line before any
  548. <code>-l</code> flags.
  549.  
  550. <p>Note that order is important!  If you search
  551. <code>/usr/freeware/include</code> before <code>/usr/include</code>,
  552. you should also search <code>/usr/freeware/lib32</code> before
  553. <code>/usr/lib32</code>.  Putting the freeware paths before the
  554. standard system paths and using all possible freeware libraries will
  555. reduce trouble.
  556.  
  557. <p>
  558. Additionally, it is a good idea to include the following flag on your
  559. link lines:
  560. <br>
  561. <ul><pre>
  562. <li>-rpath /usr/freeware/lib32 (if using n32 ABI)</li>
  563. <li>-rpath /usr/freeware/lib64 (if using 64 ABI)</li>
  564. </pre></ul>
  565. This flag will let the binary to locate the shared object library
  566. files when the application is run.  This is useful since the shared
  567. objects are stored in <i>/usr/freeware</i> subdirectories which
  568. are not searched by the run-time linker by default.
  569.  
  570. <p>
  571. Finally, if you are building an installable package for inst
  572. (contributing to freeware, for example) be sure to prereq
  573. this package.  Get the lower bound for the prereq range from the
  574. installed package, and use 1289999900 for the upper bound.  (If this
  575. doesn't make sense then it's probably not something you need to know;
  576. don't worry about it!)
  577.  
  578. </dl>
  579.  
  580. <!-- ================================================================  -->
  581. <hr noshade>
  582. <h2><a name="gnome">GNOME</a></h2>
  583.  
  584. <dl>
  585. <dt><a name="Q4.1"><b>Q4.1: What freeware images do I need to install to run GNOME?</b></a>
  586. <p>
  587.  
  588. <dd>There are a lot!  The current archive contents are a "top-of-tree"
  589. snapshot of GNOME taken roughly at the end of September, around the
  590. time that GNOME 1.4.1 was being released.
  591.  
  592. <p>An easy way to download what you need is with the <a
  593. href="selections/inst-get">inst-get</a> script.  It's not fancy,
  594. but it will try to fetch all the freeware prereqs for a given package.
  595. It uses <a href="http://freeware.sgi.com/index-by-alpha.html#wget" target="fw_index">wget</a> 
  596. to download files, so you must install that first.
  597.  
  598. <p>Alternatively, we've included an inst selections file
  599. that installs all the prerequisites you need after you manually
  600. download them. Just install <code>fw_common.sw.selections</code>, and follow the
  601. instructions in the files: <a href="selections.html">/usr/freeware/selections/</a>.
  602.  
  603. <p>If you want everything related to GNOME you'll need the packages listed
  604. alphabetically below.  This data was extracted from the <a
  605. href="http://freeware.sgi.com/prereq.ps">graphical</a> and <a
  606. href="http://freeware.sgi.com/prereq.txt">text</a> descriptions of
  607. the freeware prereqs.
  608. <TABLE CELLSPACING="20">
  609. <tr>
  610. <td valign="TOP">
  611. fw_Eterm
  612. <br>fw_GConf
  613. <br>fw_HDF
  614. <br>fw_ImageMagick
  615. <br>fw_ORBit
  616. <br>fw_PAM
  617. <br>fw_audiofile
  618. <br>fw_balsa
  619. <br>fw_bonobo
  620. <br>fw_bug-buddy
  621. <br>fw_bzip2
  622. <br>fw_control-center
  623. <br>fw_cvs
  624. <br>fw_db
  625. <br>fw_db3
  626. <br>fw_dia
  627. <br>fw_ee
  628. <br>fw_enlightenment
  629. <br>fw_esound
  630. <br>fw_findutils
  631. <br>fw_fnlib
  632. <br>fw_fortune-mod
  633. <br>fw_freetype
  634. <br>fw_freetype2
  635. <br>fw_gal
  636. <br>fw_gcc
  637. <br>fw_gb
  638. <br>fw_gdb
  639. </td>
  640. <td valign="TOP">
  641. fw_gdbm
  642. <br>fw_gdk-pixbuf
  643. <br>fw_gedit
  644. <br>fw_gettext
  645. <br>fw_gftp
  646. <br>fw_ggv
  647. <br>fw_ghex
  648. <br>fw_ghostscript
  649. <br>fw_glade
  650. <br>fw_glib
  651. <br>fw_gmp
  652. <br>fw_gnome-applets
  653. <br>fw_gnome-audio
  654. <br>fw_gnome-core
  655. <br>fw_gnome-games
  656. <br>fw_gnome-libs
  657. <br>fw_gnome-media
  658. <br>fw_gnome-mime-data
  659. <br>fw_gnome-pilot
  660. <br>fw_gnome-pim
  661. <br>fw_gnome-print
  662. <br>fw_gnome-python
  663. <br>fw_gnome-user-docs
  664. <br>fw_gnome-utils
  665. <br>fw_gnome-vfs
  666. <br>fw_gnumeric
  667. <br>fw_gtk+
  668. <br>fw_gtk-engines
  669. </td>
  670. <td valign="TOP">
  671. fw_gtop
  672. <br>fw_guile
  673. <br>fw_imlib
  674. <br>fw_indent
  675. <br>fw_ispell
  676. <br>fw_lcms
  677. <br>fw_libesmtp
  678. <br>fw_libghttp
  679. <br>fw_libglade
  680. <br>fw_libgtop
  681. <br>fw_libiconv
  682. <br>fw_libjpeg
  683. <br>fw_libole2
  684. <br>fw_libpng
  685. <br>fw_libproplist
  686. <br>fw_librep
  687. <br>fw_libtool
  688. <br>fw_libungif
  689. <br>fw_libunicode
  690. <br>fw_libwmf
  691. <br>fw_libxml
  692. <br>fw_libxml2
  693. <br>fw_libxpm
  694. <br>fw_libz
  695. <br>fw_lynx
  696. <br>fw_mc
  697. <br>fw_mysql
  698. <br>fw_nas
  699. </td>
  700. <td valign="TOP">
  701. fw_netpbm
  702. <br>fw_oaf
  703. <br>fw_openssh
  704. <br>fw_openssl
  705. <br>fw_pcre
  706. <br>fw_perl
  707. <br>fw_pilot-link
  708. <br>fw_popt
  709. <br>fw_pspell
  710. <br>fw_pspell-ispell
  711. <br>fw_python
  712. <br>fw_python2
  713. <br>fw_readline
  714. <br>fw_rep-gtk
  715. <br>fw_sawfish
  716. <br>fw_scrollkeeper
  717. <br>fw_socks5
  718. <br>fw_sox
  719. <br>fw_tar
  720. <br>fw_tcl80
  721. <br>fw_tcp_wrappers
  722. <br>fw_texinfo
  723. <br>fw_tiff
  724. <br>fw_tk80
  725. <br>fw_urt
  726. <!-- <br>fw_xalf -->
  727. <br>fw_xchat
  728. <br>fw_xscreensaver
  729. </td>
  730. </tr>
  731. </table>
  732.  
  733. <p>
  734. If you choose to install some of the non-default variants you may need
  735. other images too, like <code>fw_socks5</code>.  
  736. Also note that the <code>fw_ImageMagick.sw.plugins</code> subsystem
  737. has many additional requirements not included above.
  738.  
  739. <p>
  740. Images that aren't strictly part of GNOME, but which
  741. have GNOME support or are otherwise related, include:
  742. <ul>
  743. <li>fw_Eterm
  744. <li>fw_abiword
  745. <li>fw_gftp
  746. <li>fw_rxvt
  747. <li>fw_xmms
  748. </ul>
  749.  
  750. <p>
  751. <dt><a name="Q4.2"><b>Q4.2: How can I start GNOME automatically at login?</b></a>
  752. <p>
  753. <dd>This is covered in the <a
  754. href="http://www.gnome.org/users-guide/project.shtml">GNOME Users 
  755. Guide</a>, which should be installed in
  756. <code>/usr/freeware/share/gnome/help/gnome-users-guide/C/index.html</code>
  757. on your system.  Basically put <pre>
  758.     exec gnome-session 1>.xsession.log 2>&1</pre> 
  759. in your <code>.xsession</code> file.  The default IRIX script is in
  760. <code>/var/X11/xdm/Xsession</code> if you want to duplicate parts of
  761. your IRIX setup.
  762.  
  763. <p>
  764. <dt><a name="Q4.3"><b>Q4.3: Why do I get BadMatch errors, crashes, blue-on-blue text, etc.?</b></a>
  765. <p>
  766. <dd>Many Linux systems use a single X visual and colormap for all
  767. windows by default; IRIX doesn't.  As a result there are a variety of
  768. bugs lurking in the source code where programmers have, for example,
  769. allocated colors in the wrong colormap or assumed that all windows
  770. have the same depth.  Try making your default X server
  771. visual 24-bit TrueColor by adding "<code>-depth 24 -class
  772. TrueColor</code>" to <code>/usr/lib/X11/xdm/Xservers</code>.  (Run
  773. <b>xdpyinfo</b> first to make sure your server supports this visual,
  774. and be sure to restart the X server after making a change.  Logging
  775. out may not be enough!)
  776.  
  777. <p>
  778. <dt><a name="Q4.4"><b>Q4.4: How can I make enlightenment run faster?</b></a>
  779. <p>
  780. <dd>There are many options in the configuration page.  The
  781. <code>Pixmap</code> theme in particular is very sluggish on older
  782. machines; avoid it.
  783.  
  784. <p>
  785. <dt><a name="Q4.5"><b>Q4.5: Why are sounds garbled or noisy?</b></a>
  786. <p>
  787. <dd>These problems are thought to be solved, but if you run into them
  788. you may have better luck by forcing <b>esd</b> to start in 8-bit
  789. mode.
  790.  
  791. <p>
  792. <dt><a name="Q4.6"><b>Q4.6: Why don't gtop and other system monitoring tools work?</b></a>
  793. <p>
  794. <dd>The <code>libgtop</code> library is very system-specific, and has
  795. not been ported to IRIX.  As a result nearly all of its functionality
  796. is stubbed out.
  797. </dl>
  798.  
  799.  
  800. <!-- ================================================================  -->
  801. <hr noshade>
  802. <h2><a name="history">Known Package Replacement Histories</a></h2>
  803.  
  804. <dl>
  805.  
  806. <dt><a name="Q5.1"><b>Q5.1: What packages are known Y2K fixed?</b></a>
  807. <dd>As has been previously stated, we do not officially test for Y2K
  808. compliancy; we only fix the problems as they are reported.  Again, this
  809. goes back to our core mantra "If we don't know it's broken, we can't
  810. fix it" so please email a report of any problems you encounter to us!
  811.  
  812. <p>The following packages are Y2K fixed packages, and their release date:
  813.  
  814. <UL>
  815. <LI>fw_elm, February 2000
  816. <LI>fw_sc, February 2000
  817. </UL>
  818.  
  819. <p>
  820. <dt><a name="Q5.2"><b>Q5.2: What packages have been replaced or obsoleted?</b></a>
  821. <dd>Here's our known list of replacements or obsoletions, and the
  822. release where they took effect :
  823. <UL>
  824. <LI>fw_bladeenc, dropped for legal concerns, May 2002
  825. <LI>fw_cdrecord, absorbed by fw_cdrtools, February 2002
  826. <LI>fw_colorls, replaced by fw_fileutils, February 2000
  827. <LI>fw_egcs, absorbed by fw_gcc 3.0, August 2001
  828. <LI>fw_gnome-admin, absorbed by fw_gnome-utils, August 2000
  829. <LI>fw_gnomehack, dropped as obsolete, August 2002
  830. <LI>fw_libstdc++, absorbed by fw_gcc 3.0, August 2001
  831. <LI>fw_mkhybrid, absorbed by fw_cdrtools, February 2002
  832. <LI>fw_mkisofs, absorbed by fw_cdrtools, February 2002
  833. <LI>fw_mozilla-src, absorbed by fw_mozilla, November 2002
  834. <LI>fw_vnc, replaced by fw_tightvnc, August 2002
  835. </UL>
  836.  
  837. <p>
  838. <dt><a name="Q5.3"><b>Q5.3: What packages have been renamed?</b></a>
  839. <dd>Here's a partial list of recent name changes, along with the
  840. release where they took effect :
  841. <UL>
  842. <LI>fw_abi became fw_abiword, November 2001
  843. <LI>fw_elisp-intro became fw_emacs-lisp-intro, August 2002
  844. <LI>fw_mswordview became fw_wv, November 2001
  845. <LI>fw_sane split into fw_sane-backends and fw_sane-fronteneds, November 2002
  846. <LI>fw_users-guide became fw_gnome-user-docs, November 2001
  847. <LI>fw_xntp became fw_ntp, August 2001
  848. </UL>
  849.  
  850. </dl>
  851.  
  852.  
  853. <!-- ================================================================  -->
  854. <center>
  855. <hr noshade>
  856. Additions and contributions to this list gratefully accepted.
  857. <br>
  858. <a href="mailto:freeware@sgi.com?Subject=SGI/Freeware%20FAQ">freeware@sgi.com</a>
  859. <hr noshade>
  860. </center>
  861. <!-- END CONTENTS -->
  862.